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THE MONKEY WRENCH II (tm) 

USERS GUIDE 


WHAT IS THE MONKEY WRENCH ? 


The MONKEY WRENCH II is a program development aid that is to be 
used with ATARI BASIC. It adds extra features to the operating 
system that cut down on the time to write or modify a BASIC program 
and makes programming a joy. Why spend extra hours working on a 
BASIC program when the MONKEY WRENCH can do it for you in seconds. 
This package is a must for the BASIC programmer. If you're a person 
who likes to 'monkey around' with the ATARI, the MONKEY WRENCH II is 
for you. 

The MONKEY WRENCH is a machine language cartridge which extends the 
operating capability of the ATARI 800 or ATARI XL series computers. 
(Specify ATARI 800 or ATARI XL computer when ordering - one cartridge 
will not function in both computers). When installed into the ATARI, 
the MONKEY WRENCH provides 33 new direct mode BASIC commands and 
functions. The MONKEY WRENCH features are: 


Auto Line Numbering - Provides new line numbers automatically 
when entering BASIC program lines. Thus 
you don't have to type the line number 
for each line. 

Renumber - Renumbers BASIC's line numbers including 

internal references. 


Delete Line Numbers - Removes a range BASIC line numbers. 


Variables 


- Display ail BAbiC variables ana Uieii. 

current value. 


Scrolling 


Find String 
Xchange String 


Move Lines 


- Scroll up or down BASIC program. Use the 
START and SELECT keys to display BASIC 
lines automatically. 

- Find every occurrence of a string. 

- Find every occurrence of a string and 
replace it with another string. 

- Move lines from one part of program to 
another part of program. 
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Copy Lines - Copy lines from one part of program to 

another part of program. 

Formatted List - Print BASIC program in special line format 

and provide automatic page numbering, 

DOS Functions - Six disk utility package (DUP) type commands. 

Change Margins - Provides the capability to easily change 

the screen margins. 

Home Functions - Move cursor to top, bottom, right, or left 

of screen, (not on 800 version) 

Cursor Exchange - Allows usage of the cursor keys without 

holding down the CTRL key. 

Upper Case Lock - Keeps the computer in the upper case 

character set. 

Hex Conversion - Converts a hexidecimal number to a decimal 

number. 

Decimal Conversion - Converts a decimal number to a hexdecimal 
number. 

Function Keys - Prints commonly used BASIC commands. 

Monitor - Enter the machine language monitor. 


In addition to the BASIC commands, the MONKEY WRENCH also contains a 
machine language monitor with 16 commands used to interact with the 
powerful features of the 6502 microprocessor. 

The MONKEY WRENCH can also make backup copies of 'normal boot' type 
cassette programs. The MONKEY WRENCH for the ATARI 800 plugs into 
the right cartridge slot while the MONKEY WRENCH for the XL computers 
plugs into the single cartridge slot. 
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GETTING STARTED 


(A)-- ATARI 800 COMPUTER 


Normally, the Monkey Wrench is installed at the same time as the 
ATARI BASIC cartridge. The Monkey Wrench cartridge is inserted into 
the RIGHT CARTRIDGE slot. Once the Monkey Wrench is inserted into 
the RIGHT slot, turn on the power switch (see NOTE 1). The computer 
will initialize and display READY as normal. To initialize the 
MONKEY WRENCH cartridge, type X=USR(32768) and depress RETURN key. 
The screen will display: 


THE MONKEY WRENCH II 
COPYRIGHT 1983 BY 
EASTERN HOUSE 

Now you're ready to MONKEY around with the commands !!! 


(B)-- ATARI XL SERIES COMPUTER 


The Monkey Wrench cartridge is inserted into the cartridge slot 
on top of the computer (as does any game cartridge). Even though the 
Monkey Wrench is installed in the cartridge slot, ATARI BASIC will 
still function normally. Turn on the power. The computer will 
initialize and display READY as normal. To initialize the MONKEY 
WRENCH cartridge, type X=USR(32768) and depress RETURN key. The 
screen will display: 


THE MONKEY WRENCH II 
COPYRIGHT 1983 BY 
EASTERN HOUSE 


Once the Monkey Wrench Is initialized, going to DOS or depressing the 
RESET key will not deactivate the cartridge. Now you're ready to 
MONKEY around with the commands f ’’ 
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(C)-- IMPORTANT INFORMATION 


NOTE: Since the right slot is not normally used on the ATARI 800, the 
contacts in the slot may become dirty and cause the MONKEY WRENCH to 
malfunction when first installed. To help clean the contacts, wipe 
some alcohol on the fingers of the Monkey Wrench board and plug it in 
and then out of the right slot several times. During normal usage, 
the fingers on the board can be cleaned using a pencil eraser. 


*** NOTE 1 *** 

It is important to note that the Monkey Wrench is a program 
development aid. It is intended to be used with ATARI BASIC. It 
contains very complex software. For this reason, it should be 
removed from the computer when running programs or games. Running a 
program with it installed may cause the program to function 
improperly. 


BASIC COMMAND DETAILS 


The 33 new BASIC commands and functions are designed to give you 
those extra features that are not provided by the ATARI BASIC. These 
commands must be executed in the direct mode. That is, they cannot 
be entered into a BASIC program. They must typed on the screen 
without a line number. 

All of the Monkey Wrench commands must be entered with the 
greater than symbol (>) preceding the command syntax. In addition, 
all of the commands must be entered with the greater than symbol (>) 
in the first character position on the line. Finally, all commands 
with parameters must contain at least one space between all of the 
parameters (as shown in examples). 


*** IMPORTANT NOTE *** 

In ATARI BASIC, it is possible for a line to be longer than three 
physical lines after it has been entered. This is a poor programming 
practice which will cause problems at some future time. Due to the 
nature of the Monkey Wrench, it will truncate all BASIC lines longer 
than 120 characters in length (approximately three physical lines). 
Thus always ensure all BASIC lines are less than 120 characters. 
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AUTOMATIC LINE NUMBERING 


>A (line number) (increment value) 


The >A command provides automatic line numbering for entering 
your BASIC program. The first parameter entered is the starting line 
number. The second parameter is the increment value used to 
determine the value of the next line number. If the increment value 
is not entered, the increment value defaults to 10. Now whenever you 
enter your BASIC line statements and depress RETURN, the next line 
number will automatically be displayed on the next line of the 
screen. This feature allows for full screen editing and still 
maintains the auto numbering mode. 

To exit the automatic line numbering mode, depress the BREAK 

key. 


EXAMPLES: 

>A 10 10 

10 REM The old dog has flees!! 
20 REM But he doesn't care!! 

30 


* Start automatic 

* line numbering 

* at line 10 and 

* increment by 10 


>A 5000 1 

5000 GOTO 1000 

5001 IF A-123 THEN B=32I 

5002 LET C=0 

5003 


* Start automatic 

* line numbering 

* at line 5000 and 

* increment by 1 


EXCHANGE CURSOR KEYS 


>E 


When the Monkey Wrench is initialized at power-up, the cursor 
keys (up, down, left and right) are setup to allow their usage 
without holding down the CTRL key. This feature makes it much more 
easier to use the screen editing capabilities of the ATARI. To use 
the +, -, * and * characters, hold down the CTRL key. If you don't 
wish to use this feature, type in the >E command to exchange the 
characters to the normal mode. If at a later time you wish this 
feature restored, type >E again to exchange the keys. 
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DELETE RANGE OF LINE NUMBERS 


>D (starting line number) (ending line number) 


The >D command deletes a range of BASIC line numbers. The first 
parameter specifies the starting line number to be deleted. The 
second parameter specifies the last line number to be deleted. 

EXAMPLES: 

>D 0 50 * Delete lines 0 to 50 

>D 100 200 * Delete lines 100 200 

>D 32000 32500 * Delete lines 32000 to 32500 

When the RETURN key is depressed, the lines will be deleted. The 

ATARI buzzer will sound when the lines have been deleted. 

*** IMPORTANT NOTE *** 

Due to a problem in ATARI BASIC, deleteing lines may cause the 
computer to lockup. This problem can happen whether or not the 
Monkey Wrench is installed. Although it is not a serious problem and 
doesn't happen very often, it can happen. Therefore, be aware of 
this problem and always keep a current backup copy of the program. 


UPPER CASE LOCK 


>U 


Turn the upper case feature on or off. How many times have you 
went to depress the RETURN key only to depress the CAPS LOWR key 
instead. ATARI BASIC does not like lower case; therefore, this is a 
very annoying occurrence. The upper case feature will keep the 
computer in the upper case character set and disable the lower case 
character set. 

When the computer is turned on, the upper case lock feature is 
enabled. To disable the upper case lock feature and return to normal 
key usage, type >U. To enable the upper case lock feature again, 
type >U. 
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DECIMAL TO HEXIDECIMAL CONVERSION 


># (decimal number) 


Convert a decimal number to hexidecimal number. When the RETURN 
key is depressed, the hexidecimal number will be displayed on the 
next line. The maximum decimal number is 65535. 

EXAMPLES: 

># 255 

OOFF 

># 10 
000A 

># 65535 

FFFF 


HEXIDECIMAL TO DECIMAL CONVERSION 


>$ (hexidecimal number) 


Convert a hexidecimal number to a decimal number. When the 
RETURN key is depressed, the decimal number will be displayed on the 
next line. The maximum hexidecimal number is FFFF. 

EXAMPLES: 

>$ FF 
255 

>$ A 
10 

>$ FFFF 
65535 
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RENUMBER BASIC PROGRAM 


>R (start line number) (increment value) 


The >R command will renumber all BASIC lines in a BASIC program. 

It will renumber not only the line numbers but also all references to 
the line number by the following BASIC commands: GOTO, GOSUB, IF 
THEN, ON GOTO, ON GOSUB, RESTORE, and TRAP. 

If the renumber routine finds that a reference is made to a 
nonexistent BASIC line number, it will change the reference to line 
number 32767. Therefore, it will be easy to locate when scanning a 
listing of the program. In addition, when the BASIC program is RUN, 
an error message will be given. 

The first parameter of the >R command specifies the starting 
line number. That is, the first line number you want the program to 
have. The second parameter specifies the increment value (or the 
number of line numbers) between lines. The increment value can be 
from 1 to 255. If the increment value is not entered, it will 
default to 10. 

EXAMPLES: 

>R 10 * Renumber program with the first new 

* line number being 10. An increment 

* value of 10 will be assumed. The new 

* line numbers will look like 10, 20, 

* 30, 40, 50, etc. 

>R 1 1 * Renumber program with the first new 

* line number being 1 and an increment 

* value of 1. The new line numbers will 

* look like 1, 2, 3, 4, 5, 6, 7, etc. 

>R 32000 50 * Renumber program with the first new 

* line number being 32000 and an increment 

* value of 50. The new line numbers will 

* look like 32000, 32050, 32100, etc. 
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Additional Facts About Using Renumber !! ! 

1. Normally, it should only take seconds for a renumber to 
complete. 

2. The renumber command uses the screen RAM memory as a 
buffer. Therfore in graphics mode 0, the longest BASIC program that 
can be renumbered is 478 lines. An error message PROGRAM TO LONG FOR 
SCREEN MEMORY will be given if the program is to long. If necessary, 
the graphics mode may be changed to GRAPHICS 6 before renumbering the 
program. This will double the number of lines that can be 
renumbered. 

3. The screen will go blank during the time the program is 
being renumbered. This is normal and no cause for alarm. 

4. The maximum line number used by the >R command is 32766. 
Thus use the increment value carefully at high starting line numbers. 
An error message OUT OF NUMBERS will be given if this occurs. In 
this case, the BASIC program will be only partially renumbered and 
therefore is useless. Reload the BASIC program and renumber again. 

5. There are many ways of constructing BASIC programs. 
Therefore it Is impossible for the renumber routine to know exactly 
what the programmer had in mind. The following is a list of examples 
of BASIC commands which the renumber routine may or may not act upon. 

* The renumber routine will not renumber BASIC statements 

which use symbolic labels as line numbers. For example, 

10 LET CAT-50 

20 GOTO CAT 

* Be carefull of the following BASIC format: 

10 IF A-l THEN 100 4- A 

The above format is OK. The 100 will be renumbered. 

10 IF A-l THEN A + 100 

In this format, the 100 will not be renumbered. 

Note: This applies not only to the IF THEN 

command but also to the other commands. 



PAGE 10 


FIND STRING COMMAND 


>F d string d (start line) (end line) 

The >F command will search through BASIC lines and find all 
occurrences of a string and print to screen. The 'd' in the command 
format is a delimiter character. It is used to indicate the start 
and end of the string to be searched for in the program. The 
delimiter character can be any character entered on the keyboard. 
The same delimiter character used to indicate the start of the string 
MUST also be used to indicate the end of the string. 

The string can be any characters entered from the keyboard 
(except the character used as the delimiter and the % character). 
The percent character (%) is used as a 'do not care' character. That 
is, any character found at that place in the string will be accepted 
as part of the string during a search. For example, the string 
ABC%%FG will cause any of the following strings to be accepted by the 
find command as valid -» ABCDEFG, ABC12FG, ABCXYFG, and ABC FG. 

A range of line numbers can be specified by entering the start 
and end line numbers. If no line numbers are given, the find command 
will search through all BASIC lines. A space must seperate the start 
and end line numbers. 

EXAMPLES: 


>F 

/ABCD/ 50 275 

Find 

ABCD 

all ocurrences of the string 
in lines 50 through 275. 

>F 

/TRAP 2000/ 

Find 

TRAP 

all occurrences of the string 
2000 in all BASIC lines. 

>F 

/G0%%/ 

Find all occurrences of the string 
GO followed by two 'do not care' 


characters. Note that in this case, 
the find command will display all 
lines which contain GOTO commands 
as well as GOSUB commands and anything 
else that matches. 
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>F /FOR/ Find all occurrences of the string FOR. 

As in the previous example, it will find 
every FOR, FORMAT, FOREVER, etc. 

>F ?TOTAL/NUM? Find all occurrences of the string 

TOTAL/NUM. Notice in previous examples 
a slash (/) was used as the delimiter. 

In this case however, It was necessary 
to use the slash character in the string 
to indicate a divide operation. Thus it 
was necessary to use a different delimiter. 
In this case, a question mark was used 
(however any other character could have 
been used as long as it doesn't appear as 
part of the string. 

Notes: 

1- To stop the find command before it has finished, depress the 
space bar. 

2 - To stop the display on the screen without stopping the find 
command, use the CNTL-1 key. 

3- The string used by the find command mut be entered exactly 
as it is normally listed to the screen. For example, GOTOIOO 
will not be found; where as GOTO 100 will be found. This is 
because a space character always seperates the GOTO command 
from the line number. 

4- The maximum number of characters that may be used in the 
string is 40. 
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XCHANGE STRING COMMAND 


>X d search string d replace string d (start line) (end line) 

The >X command will search through BASIC lines and find all 
occurrences of a string and replace with another string. The xchange 
command works like the find command but in addition to finding the 
string it also replaces the. string it found with a new string 
(replace string) as shown in the command format. All lines where a 
string is found and replaced will be displayed on the screen. 

As with the find command, the 'd' is used as a delimiter to 
indicate the start and end of each string. It is also possible to 
use the "do not care' character in the search string of the xchange 
command. Note: The total number of characters used for the search 
and replace strings must not exceed 40 characters in length. 

A range of line numbers can be specified by entering the start 
and end line numbers. If no line numbers are given, the xchange 
command will search through all BASIC lines. A space must separate 
the start and end line numbers. 

EXAMPLES: 

>X /START/FINISH/ 1000 2500 

Search through BASIC lines 1000 to 2500 
for all occurrences of the string START 
and replace it with the string FINISH. 


>X /GOTO 100/GOTO 500/ 

Search through all BASIC lines for all 
occurrences of the string GOTO 100 and 
replace It with the string GOTO 500. 

>X /SUM=%%/SUM“0/ 

Search through all BASIC lines for all 
occurrences of the string SUM* followed 
by two 'do not care' characters and 
replace it with SUM*0. 

>X /G0SUB 5000// Search through all BASIC lines for all 

cf the string G0SUB 5000 and 
replace it with a null string. In this 
example the last two delimiters are next 
to each other indicating that there Is no 
replace string. This feature in effect 
allows the user to delete any string from 
the BASIC line. 
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>X /%// 

Try this example. It finds any character 
and deletes it. If this command is allowed 
to finish, it will delete every line from 
the computer. 

Notes: 

1- To stop the xchange command before it has finished, depress the 
space bar. 

2- To stop the display on the screen without stopping the xchange 
command, use the CNTL-1 key. 

3- The string used by the xchange command mut be entered exactly 
as it is normally listed to the screen. For example, GOTOIOO 
will not be found; where as GOTO 100 will be found. This is 
because a space character always seperates the GOTO command 
from the line number. 

4" The maximum number of characters that may be used in both the 
search and replace strings is 40. 

5- The xchange command searches for string and replaces that string 
with a new string. It does not do any syntax checking. For 
example, if GOTO 50 is replaced with GOTTO 100, a normal BASIC 
error message will result. The xchange command will not stop 
its processing. Therefore, the user should use the xchange 
command carefully and, of course, always keep a backup copy of 
the program. 


SET MARGINS 


>M (left margin) (right margin) 

The >M command makes it possible to easily change the screen 
margins. The first number in the parameter specifies the left 
margin; the second number in the parameter specifies the right 
margin. If the second parameter is not given, only the left margin 
will be changed. 

EXAMPLES: 

>M 5 35 * Set margins to 5 and 35 

>M 0 39 * Set margins to 0 and 39 

>M 2 * Set left margin to 2 

The lowest left margin number is 0 and the highest right margin 
number is 39. Don't specify a left margin number greater than the 
right margin. If you do, use the SYSTEM RESET key to reset the 
margins. 
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SCROLL ENABLE COMMAND 


>SE 


The scroll enable command allows the user to scroll (list) BASIC 
lines to the screen by using the START and SELECT keys. The START 
key will scroll down BASIC lines; that is, to higher BASIC line 
numbers. The next higher BASIC line number will be displayed at the 
bottom of the screen with all other lines being moved up the screen. 
The SELECT key will scroll up BASIC lines; that is, to lower line 
numbers. The next lower line number will br displayed at the top of 
the screen. 

As discussed above, the START and SELECT keys will cause the 
next higher or lower line number to be displayed on the screen. How 
does the scroll routine know what the next line is to be ? This is 
accomplished by looking at the current line numbers on the screen. 
If the screen is clear, the scroll will start at the first or last 
BASIC line number depending on whether the SELECT or START key was 
depressed. 

In order to experiment with the scroll feature, load a BASIC 
program which contains at least 30 lines. Clear the screen. Now 
depress and hold the START key. As seen, each BASIC line number is 
displayed at the bottom of the screen and moves up the screen as each 
new line is displayed. How do you know when the last line is 
displayed ? The ATARI 'buzzer' will sound. Now depress and hold the 
SELECT key. As seen, the next lower BASIC line number is displayed 
at the top of the screen with all other lines moving down the screen. 
Hold down the SELECT key until the the first line is displayed. How 
do you know when the first line is displayed ? Again, the ATARI 
'buzzer' will sound. 

Clear the screen. Type ia a number which represents a BASIC 
line number that is near the middle of the BASIC program. DO NOT 
DEPRESS RETURNl Depress the START key and observe the next higher 
line number being displayed at the bottom of the screen. This 
feature allows the user to scroll starting at any line desired. 

Another feature of the scroll routine is the ability to insert 
blank lines using the OPTION key. Move the cursor to the place on 
the screen you wish to insert a blank line and depress the OPTION 
key. The blank line will be inserted and the ATARI 'buzzer' will 
sound. 

Note 1 - The scroll feature is enabled when the computer is turned on. 
To disable the scroll feature, type >S. 

Note 2- The START and SELECT keys MUST only be used during Graphics 
Mode 0. Using the scroll feature in any other mode will cause the 
computer to malfunction. 
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FORMATTED LIST COMMAND 


>L (start line) (end line) 
>LP (start line) (end line) 


The formatted list command list BASIC lines to the screen 
(and/or printer using >LP command). This command does the same thing 
as the normal list command. However, the >L command formates’ the 
line when multiple BASIC commands are in the same line. That is, 
whenever a BASIC line contains more then one command, the commands 
will be left justified on the screen or printer. In addition, the 
command also prints page numbers at the top of each page. This is 
very usefull when sending listing to the printer via the >LP command. 
The following is an example of the printout. 

PAGE 1 

110 GOSUB 2500 
:G0SUB 3000 
120 IF A-B THEN 10 
:IF A<B THEN 20 
:IF A>B THEN 30 
130 X*100 
:Y«210 

This formatted list allows easier viewing of a BASIC program when 
multiple commands per line are used. The Range of lines to be listed 
may be specified by entering the start and end line numbers. If no 
line numbers are entered, all lines will be listed. The >L and >LP 
commands can be aborted by depressing the space bar. 

Note: DO NOT try to do any screen editing of the formatted lines. 
BASIC will not recognize the entire line. 
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VARIABLES COMMAND 


>V 

>VP 

The >V command will display ail BASIC variables and their current 
value. The >VP command will also send the variables to the printer. 
This includes variables used as constants and strings. In the case 
of arrays, only the array name will be displayed (the content of the 
array will not be displayed). Anytime a string or array name is 
displayed, the current DIM value(s) will also be displayed. If the 
string or array has not been dimensioned, a 'V' will be displayed to 
indicate it is 'un-dimensioned'. 

Example: 

>V 

NUM =1234 
A$ [16 ] -ABCDEF 

x$ [u ] 

XYZ( [18,20] 

*4 

In the above example, the the variable NUM and its current value is 
shown. The second line contains a string A$, the dimension [16] and 
the current contents of the string ABCDEF. String variables are 
always followed by a dollar sign $. The third line in the example is 
also a string variable. However, the string has not been dimensioned 
which is shown by the [U]. The forth line contains an array 
variable. As shown, the array variable name ends with a ( and the 
current dimensions follow. The last line contains an asterisk and 
the number of variables in the program. 

NOTE: The variables command will display every variable in the system 
variables table. This table contains every variable that was used 
while entering the program. Therefore, the table may contain some 
variables that were once used in the program but were later deleted. 
To eliminate these unused variables, use the LIST command to save the 
program to disk or cassette. Then load the program using the ENTER 
command. Now only the variables used in the program will be 
contained in the table. 
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COPY COMMAND 


>CO (start line) (end line) (destination line) 


The >C0 command copies BASIC lines from one area of the program 
to another. The range of lines to be copied is specified by the 
start line and end line parameters as shown in the command format. 
The destination line parameter specifies the first line number where 
the new lines will be stored. The destination line number will be 
incremented by 1 for each line copied. For example, if lines 10 thru 

18° !58 Hfii ?i?2 h Ss^epresseJf tg2 k liiS e belgi 

copied will be displayed on the screen. To abort the copy command 
before it has completed, depress the space bar. When the last line 
has been copied, the buzzer will sound. 

IMPORTANT: The copy command copies the lines exactly as they are 
stored. Therefore, all line references must be corrected by the 
user. Also, it is possible to copy lines over existing BASIC lines. 
Therefore, be careful when specifing the destination address (unless 
it is intended to overwrite the lines). 

Note: It is not possible to specify a destination line number that 
falls between the start and end line numbers. An error will be given 
if this happens. 
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MOVE COMMAND 


>MO (start line) (end line) (destination line) 


The >MO command moves BASIC lines from one area of the program 
to another. The original lines are deleted. The range of lines to 
be moved is specified by the start line and end line parameters as 
shown in the command format. The destination line parameter 
specifies the first line number where the new lines will be stored. 
The destination line number will be incremented by 1 for each line 
moved. For example, if lines 10 thru 100 are to be moved to line 
32000, the command would look like >M0 10 100 32000. After the 
return key is depressed, the lines being moved will be displayed on 
the screen. The original lines specified by start and end are 
deleted. To abort. the move command before it has completed, 
depress the space bar. When the last line has been moved, the buzzer 
will sound. 

IMPORTANT: The move command moves the lines exactly as they are 
stored. Therefore, all line references must be corrected by the 
user. Also, it is possible to move lines over existing BASIC lines. 
Therefore, be careful when specifing the destination address (unless 
it is intended to overwrite the lines). 

Note: It is not possible to specify a destination line number that 
falls between the start and end line numbers. An error will be given 
if this happens. 


ENTER MONITOR 


>* 


Enter the machine language monitor. The >* command exits the 
ATARI BASIC program and turns control of the 6502 microprocessor over 
to the monitor. See machine language monitor commands. 
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DOS FUNCTIONS 


The following disk operating system (DOS) functions are directly 
available with the Monkey Wrench without loading the disk utility 
package (DUP). The following is a discussion of each command. 


DISK DIRECTORY COMMAND 


»x 

»xP 

The »x command will display the disk directory of the disk drive 
where x is the disk drive number. If a P character is used after the 
disk drive number, then the disk directory will also be sent to the 
printer. 

EXAMPLES: 

>>2 - Display directory on disk drive number 2 

>>4 - Display directory on disk drive number 4 

>> - Display directory on disk drive number 1. 

As shown in this example, no drive number was entered. 

In this case, the drive number defaults to 1. 

»1P - Display directory on disk drive number 1 and also send 

it to the printer. 

>>2P - Display directory on disk drive number 2 and also send 

it to the printer. 
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FORMAT DISKETTE 


»Fx 

Format the diskette contained in disk drive x, where x is drive 
number 1 to 4. After the diskette is formated, the directory will 
be displayed. 

CAUTION: Be sure the diskette to be formatted is in the disk drive 
specified. The format command does not give you a second chance. 

Examples: 

>>F1 - Format diskette in disk drive number 1. 

>>F4 - Format diskette in disk drive number 4. 

Note: If the system is using DOS-2, the format will be in DOS-2. 

If the system is using DOS-3, the format will be in DOS-3. 


UNLOCK FILE 


»U filename 

Unlock a file as specified by the filename. This command unlocks a 
file for writing. See DOS manual. 

Examples: 

»U Dl:TEMP.BAS -Unlock a file named TEMP.BAS on drive 1 

»U D2:HELP -Unlock a file named HELP on drive 2 


LOCK FILE 


»L filename 

Lock a file as specified by the filename. This command locks a 
file from writing. See DOS manual. 

Examples: 

>>L D2:HELP -Lock a file named HELP on drive 2 

»L Dl:MESS -Lock a file named MESS on drive 1 
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DELETE FILE 


>>D filename 

Delete the file as specified by filename. 

CAUTION: Be sure the file to be deleted Is correctly 
specified. The delete command does not give you a second chance. 

Examples: 

»D D2:HELP -Delete a file named HELP on drive 2 

>>D DliMESS -Delete a file named MESS on drive 1 


RENAME FILE 


»R filename,filename 

Rename a file from one name to another. See DOS manual. 

Examples: 

»R Dl:OLD,NEW -Rename a file from OLD to NEW on 

disk drive number 1. 

»R D2:TEMP,PERM -Rename a file from TEMP to PERM on 

disk drive number 2. 

»R D2:HELP.TMP,HELP.BAS -Rename a file from HELP.TMP to 

HELP.BAS on disk drive number 2. 


FUNCTION KEYS 


The Monkey Wrench incorporates a special function that allows the 
printing of certain commonly used commands. This feature saves on typing 
and ease of using the commands. This feature is accessed by depressing 
the CONTROL key and the number keys 5 through 0. The following is an 
example of what each key will produce on the screen: 


control-0 

control-9 

control-8 

control-7 

control-6 

control-5 


- SAVE "D 

- LOAD "D 

- RUN "D 
= LIST "D 
= ENTER "D 
= PRINT//6 
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HOME FUNCTIONS 

m s* sss ss sb a ss ss ss ss a ss ss ss 


control-H 
control-B 
control-L 
control-R 


Home Top 
Home Bottom 
Home Left 
Home Right 


The home key functions are designed to move the cursor to certain 
locations on the screen with a mininum of effort. The home top 
(control-H) will move the cursor to the upper-left corner of the 
screen. The home bottom (control-B) will move the cursor to the 
lower-left corner of the screen. The home left (control-L) will move 
the cursor to the left margin on the current physical line. The home 
right (control-R) will move the cursor to the right margin on the 
current physical line. 


NOTE: The home functions do not operate on the ATARI 800 
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MACHINE LANGUAGE MONITOR (MLM) COMMANDS 


The MLM provides 16 commands which are most useful to the 
machine language programmer. It provides the user with the 
capability to easily interact with the 6502 microprocessor and system 
memory. The MLM uses the ATARI screen editing capability. This 
feature makes the MLM powerful and easy to use. 

The following is a list of the MLM commands. Carefully read 

over the commands^and, examples. Then practice with the MLM to 3 gain a 
better insight Into their fise. Enter the MlM using the command >*. 


. -- COMMAND PROMPT 

A period is used to indicate the MLM is ready for a command. 


M XXXX YYYY -- DISPLAY MEMORY 

Display memory starting at hex address XXXX and ending at YYYY. 


Example - 
M 6531 653F 

:6531 01 02 03 04 05 06 07 08 
:6539 09 0A 0B 0C 0D OE OF 10 

Note -- If only start address is entered, 24 memory locations will 
be displayed. 

Note -- For long memory displays, the control-1 key can be use to 
stop and start the listing. 

Note -- To abort a long listing, press the space bar. 
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I XXXX YYYY -- INTERROGATE MEMORY 

Interrogate memory starting at hex address XXXX and ending at 
YYYY. The interrogate command works just like the .M command except 
it also displays the ATASCII equivalent of the memory contents. All 
cursor control codes are displayed with a question mark (?). 


R -- DISPLAY REGISTERS 

Display 6502 registers. 


Example Printout - 

* PC AR XR YR PR SP 
; 7013 41 11 FA 03 FA 

PC = program counter; AR = accumulator; XR * X register 
YR = Y register; PR * status register; SP * stack pointer 


: -- ALTER MEMORY 

Indicates that the following hex address and line of hex data 
will be used to alter memory. Cursur up and over to location and 
change bytes -• press RETURN. 


; -- ALTER 6502 REGISTERS 

Used to modify 6502 registers. Cursor up and over to register 
and change bytes (S) — press RETURN. 


G XXXX — GOTO 

GOTO address specified by XXXX and execute program. Program 
must contain a BRK instruction to return to MLM. If XXXX is not 
given, the GOTO address defaults to the program counter. 
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X — EXIT 

Exit the monitor and return to BASIC. 


S XXXX YYYY — SAVE MEMORY TO CASSETTE 

Save memory starting at hex address XXXX to ending address YYYY. 


Note -- The end address must be the actual address+1. 


L XXXX -- LOAD MEMORY FROM CASSETTE 

Load memory from cassette and store starting at hex address 
XXXX. At the end of the load, the screen will display END ADDRESS = 
followed by the hex address of the end of the program. Binary data 
saved using the S XXXX YYYY command can be loaded into memory at any 
location (as defined by L XXXX). 


? -- ERROR 

A question mark will be printed if a bad command or bad hex data 
is entered. It will also be given if any command tries to alter a 
ROM or non-existent memory location. 


H XXXX YYYY 'ZZZZZ -- HUNT FOR ASCII STRING 

Hunt memory from XXXX to YYYY for the ASCII string ZZZZZ 


Example - H 1700 2A80 "ATARI COMPUTER -- Hunt memory from $1700 to 
$2A80 for the ASCII string ATARI COMPUTER . 


Note - The ASCII string can be up to 20 characters long. 


Note - If a match of the ASCII string is found, the hex address will 
be listed to the screen. If no match is found, only the command 
prompt (.) will be displayed. 
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H XXXX YYYY ZZ ZZ ZZ ZZ — HUNT FOR HEX CHARACTERS 

Hunt memory from XXXX to YYYY for the hex characters ZZ ZZ ZZ 

ZZ. 


Example - H 1700 2A80 20 00 07 A9 FF -- Hunt memory from $1700 to 
$2A80 for the hex characters 20 00 07 A9 FF • 


Note - The hex characters can be up to 20 hex bytes long. 


Note - If a match of the hex characters is found, the hex address 
will be listed to the screen. If no match is found, only the command 
prompt (.) will be displayed. 


B XXXX YYYY - CALCULATE BRANCH 

Calculate the branch value from address XXXX to YYYY. 


Example - B 4000 4013 - Calculate the value of a branch instruction 
when the program counter is at $4000 and branch to instruction is at 
$4013. In this case, the hex value 13 will be displayed. 


A - ATARI DOS 

Exit the monitor and go directly to the DOS menu. If DOS isn't 
loaded, it will enter the MEMO PAD mode for the ATARI 800 or TEST 
mode for the XL computer. 
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D XXXX - DISASSEMBLE MEMORY 

Disassemble memory starting at hex address XXXX. 


Example - D AOOO - Disassemble memory starting at $A000. The screen 
will clear and display the hex code as well as the disassembled 
mnemonics. The control-1 key is used to stop and start the listing. 
To terminate the listing, press the space bar. 


, AOOO 

A5 

CA 

-LDA 

$CA 

, A002 

DO 

04 

-BNE 

</> 

> 

o 

o 

00 

, A004 

A5 

08 

-LDA 

$08 

, A006 
etc 

DO 

45 

-BNE 

$A04D 


Note - When an unimplimented opcode is encountered, the mnemonic 
field will display ???. 


, - ALTER DISASSEMBLE LISTING 

A comma command is used to alter the hex code printed out by the 
disassemble command. After the listing has been stopped with space 
bar, simply cursor up and over and change hex code (up to 3 memory 
locations can be modified). When the RETURN key is pressed, the 
disassembly process will begin again. 


PS - PRINTER SET 
PC - PRINTER CLEAR 

The printer set command allows machine language monitor 
information set to the screen to be also sent to the printer. The 
printer set command remains activated until a printer clear command 
is given. 


ADDITIONAL NOTES 


(1) Spaces have been shown in the examples of the MLM commands. 
Spaces are optional and are not required by the monitor. 

(2) In addition to the MLM commands, ten of the normal Monkey Wrench 
commands can be used. They are: >E, >U, >#, >$, »x, >>F, >>L, >>U, 
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MAKING BACKUP TAPES OF CASSETTE PROGRAMS USING THE MLM 


The Machine Language Monitor (MLM) load and save (binary data) 
commands can be used to make backup copies of cassette tape programs. 
This includes cassette tapes in boot format. The backup tape process 
is simple and requires no special knowledge by the user. Follow the 
simple steps shown below when making a backup tape: 


(1) Bootup the computer with the ATARI BASIC and Monkey Wrench 
cartridges installed. 

(2) Type >* , to enter the MLM mode. 

(3) Insert the cassette tape to be copied into the cassette recorder 
and depress the PLAY button. 

(4) To load the program, type L 0700 and depress RETURN key. The 
buzzer will beep. Depress RETURN again to start the load process. 
The sound of the data being loaded can be heard over the TV speaker. 

(5) At the end of the load, the screen will display END ADDRESS = 
followed by end hex address of the program. (Note: Although some 
users will not understand hex numbering, it is only important here to 
continue following the step procedure.) 

(6) The program is now loaded. Remove the old cassette tape and 
install a blank cassette into the recorder. Press PLAY and RECORD 
buttons on the cassette recorder. 

(7) To save the program, type S 0700 followed by 'end address' 
displayed on the screen at the end of the load. (See step 5). Be 
sure to type the end address exactly as shown on the screen and 
depress RETURN key. The buzzer will beep twice. Depress RETURN 
again to start the save process. The sound of the data being saved 
can be heard over the TV speaker. 

(8) When the sound stops, the backup tape process is completed. An 
example of the backup tape process, as seen on the screen, is shown 
below. 


* PC AR XR YR PR SP 
; 8B29 27 FF 03 31 FF 
.L 0700 

END ADDRESS = 1AF6 
.S 0700 1AF6 


Note - Some commercial type software use special recording formats to 
prevent backups. Therefore, these types of programs cannot be 
backed-up with the above steps. 
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ABOUT THE CARTRIDGE 



As stated previousily, the Monkey Wrench ROM is contained on a 
special printed circuit cartridge. This cartridge is configured such 
that it uses memory from hex 8000 to hex 9fff when inserted into the 
cartridge slot. Therefore, on an ATARI with 48k or more memory, only 
32k of memory is usable. This is ,of course, a constraint of the 
ATARI computer. 


WARRANTY INFORMATION 



The Monkey Wrench cartridge (hardware) is warranted against defects 
in material and workmanship for a period of 60 days from the date of 
purchase. If a defect is discovered during the 60 day period, and 
you have registered this warranty, Eastern House will replace or 
repair the cartridge I provided the cartridge and proof of purchase 
is mailed (postage prepaid) to Eastern House. 

If the defect (in the judgement of Eastern House) resulted from 
accident, abuse, or misapplication of the cartridge, Eastern House 
shall have no responsibility to replace or repair the cartridge under 
the terms of this warranty. After the 60 day warranty, Eastern House 
will repair the cartridge for the cost of parts and shipping. 

If you have any questions or comments about this software (good or 
bad), please write or call. Eastern House has always felt it is 
important not to abandon the user once the sale has been made. 
Please feel you can contact us if necessary. 





QUICK REFERENCE GUIDE 


Initialization - X=USR(32768) 

>A (line number) (increment value) = AUTOMATIC LINE NUMBERING 
>E - EXCHANGE CURSOR KEYS 

>D (starting line number) (ending line number) « DELETE RANGE OF LINE 
NUMBERS 

>U - UPPER CASE LOCK 

># (decimal number) - DECIMAL TO HEXIDECIMAL CONVERSION 
>$ (hexidecimal number) = HEXIDECIMAL TO DECIMAL CONVERSION 
>R (start line number) (increment value) - RENUMBER BASIC PROGRAM 
>F d string d (start line) (end line) * FIND STRING COMMAND 
>X d search string d replace string d (start line) (end line) - 
XCRANGE STRING COMMAND 

>M (left margin) (right margin) = SET MARGINS 
>SD =* SCROLL DISABLE COMMAND 
>SE = SCROLL ENABLE COMMAND 

>L (start line) (end line) - FORMATTED LIST COMMAND 

>LP (start line) (end line) = FORMATTED LIST COMMAND TO PRINTER 

>V = VARIABLES COMMAND 

>VP - VARIABLES COMMAND TO PRINTER 

>CO (start line) (end line) (destination line) = COPY COMMAND 
>M0 (start line) (end line) (destination line) ~ MOVE COMMAND 
>* = ENTER MONITOR 

DOS FUNCTIONS 

»x - DISK DIRECTORY COMMAND 

»xP - DISK DIRECTORY COMMAND TO PRINTER 

»Fx - FORMAT DISKETTE 

»U filename = UNLOCK FILE 

»L filename = LOCK FILE 

»D filename - DELETE FILE 

»R filename 5 filename = P.ENAME FILE 

FUNCTION KEYS. 


control-O = SAVE ,9 D 
control-9 ~ LOAD "D 
control-8 ■* RUN "D 
control”7 = LIST "D 
control-6 - ENTER "D 
control°5 = PRINT#6 

HOME FUNCTIONS 

control-H = Home Top 
control-B = Home Bottom 
control-L = Home Left 
control~R = Home Right 






